10 



15 



ET420197682US 

AUS92001 0930US1 - 1 - PATENT APPLICATION 

CAPTURING COMMAND EXECUTION STATUS 



RELATED APPLICATIONS 

This application relates to U.S. Application (IBM Dkt. No. AUS820011291) 
entitled "Command Script Instrumentation for Logging Command Execution and 
the Protection of Sensitive Information," filed concurrently herewith. 

FIELD OF THE INVENTION 

This invention relates to application programs prompting the execution of 
command scripts. More specifically, the invention relates to communicating the 
success or failure of command scripts back to the calling application program. 



BACKGROUND OF THE INVENTION 

Application programs often launch operating system level command 

scripts, which may contain any number of commands that must be successfully 

executed in their entirety to achieve the script's desired end. Such scripts are 
20 useful, in that they allow for powerful low-level system calls, but the available 

commands and breadth of functionality are relatively limited. 

A frequent problem is that the command processor does not pass back to 

the application program information pertaining to the success or failure status of 

the most recently executed command. And as a result, the application program 
25 that called the script may not know whether the command script has been 

executed successfully or at all. 
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Developers may be able to design application programs tliat verify 
successful execution of commands, such as moving or creating files, but this 
solution requires a new verification routine to be implemented for each command 
5 script. 

It would be desirable to have a system and method that tracks the 
success or failure status of a command, and communicates that status by means 
of a command script back to the application program that prompted its execution. 

10 BRIEF SUMMARY OF THE INVENTION 

One aspect of the invention provides a method of communicating between 
an application program and a command script. The method may comprise the 
use of a log file to store the return code of the last executed command. The log 
file may be stored on hard disk, RAM disk, or any location recognized as 

15 accessible by the command processor. The return code stored in the log file 
may provide the application program with a method for verifying the success or 
failure of each command in a command script. 

Another aspect of the invention provides a system of communicating 
between an application program and a command script. The system may 

20 comprise means of using a log file to store the return code of the last executed 
command. These means may allow the log file to be stored on hard disk, RAM 
disk, or any location recognized as accessible by the command processor. The 
return code stored in the log file provides the application program with a means 
for verifying the success or failure of each command script. 

25 



AUS920010930US1 



PATENT APPLICATION 



Another aspect of the invention may provide a computer readable medium 
storing a computer program. The computer readable medium may comprise 
computer readable code for communicating between an application program and 
5 a command script. The computer readable code makes use of a log file to store 
a return code of the last executed command. The computer readable code may 
specify that the log file be stored on a hard disk, RAM disk, or any location 
recognized as accessible by the command processor. Computer readable code 
may access the return code stored in the log file providing the application 

10 program with the success or failure status of each command script. 

The foregoing and other features and advantages of the invention will 
become further apparent from the following detailed description of the presently 
preferred embodiments, read in conjunction with the accompanying drawings. 
The detailed description and drawings are merely illustrative of the invention 

15 rather than limiting, the scope of the invention being defined by the appended 
claims and equivalents thereof. 

BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 is a block diagram illustrating one embodiment of the computer, 
20 network, and file-based system in accordance with the present invention; and 

FIG. 2 is a flowchart representation of one embodiment of the interaction 
between an application program and command script in accordance with the 
present invention. 
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DETAILED DESCRIPTION OF THE 
PRESENTLY PREFERRED EMBODIMENTS 

In FIG. 1, a network-based system 100 illustrates one embodiment of the 

5 present invention. The invention relates to the communication between 

application program 104 and command script 106 that run on a command 

processor of local computer 102. In one embodiment of the invention, 

application program 104 may require that certain commands in command script 

106 be completed successfully before the application program's operation 

10 continues. In another embodiment of the invention, application program 104 may 
provide a means of interaction with an end user. When an error occurs in 
command script 106, application program 104 may require information about that 
error, so that it may be reported to the end user. The execution of each 
command in command script 106 may generate a return code, which is a value 

15 returned to the command processor following execution of a command. This 
return code of a command in command script 106 may be required in application 
program 104. Communication from command script 106 to program application 
104 is made possible through the use of a return code file, which is a commonly 
accessible file that may store one or more return codes. A return code file, which 

20 is a commonly accessible file storing one or more return codes, may facilitate 
communication from command script 106 to program application 104. In one 
embodiment of the invention, the return code file may reside on the hard disk 108 
of local computer 102. In another embodiment the return code file may reside on 
RAM Disk 110 on the local computer 102. A computer or other network node 

25 1 12 on a network 114 may also be used to store the return code file. The return 
code file may be located anywhere recognized both by the command processor 
executing the command script 106 and application program 104. The return 
code file may be created by application program 104 or by command script 106. 
In one embodiment, command script 106 may create then return code file. 

30 Before accessing return code file, application program 104 may check for its 
existence, indicating that command script 106 has executed. 
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FIG. 2 is a flowchart that illustrates communication between application 
program 104 and command script 106. At some point in the running of an 
application program (BLOCK 202), the program may prompt the execution of a 
5 command script (BLOCK 204). In one embodiment, application program may 
create or define a return code file that may be used by the command script, prior 
to prompting the execution of the command script (BLOCK 204). The return 
code file created or defined by the application program may be stored on local 
hard disk 108, local RAM disk 110, network location 112, or some other location 

10 recognized by a command processor running the command script. After the 

application program prompts the execution of the command script (BLOCK 204), 
the command script may begin processing the commands contained therein 
(BLOCK 206). In one embodiment, the command script may create or define the 
return code file that may be used in the command script. The return code file 

15 created by the command script may be held on local hard disk 108, local RAM 
disk 110, network location 112, or some other location recognized by a command 
processor running the command script When the commands in the command 
script are executed, the command script may write the return code of the 
executed command to the return code file (BLOCK 208). The application 

20 program may pause to allow time for the command script to execute (BLOCK 
210). The application program may then check the execution status of the 
command script by accessing the return code file (BLOCK 212). In one 
embodiment, when the command script is responsible for creating the return 
code file, the application program may check for the existence of the return code 

25 file prior to accessing it (BLOCK 212). Existence of the return code file may then 
indicate that an execution of the command script was attempted, and that the 
script has executed at least to the point of creating the return code file. After 
accessing the return code file (BLOCK 212) the application program may 
proceed in whatever manner is deemed appropriate given the execution status of 

30 the command script, which was communicated by means and system already 
described. 
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The above-described methods and implementation of logging command 
execution in a command script are exemplary methods illustrating one possible 
approach for logging command execution in a command script. The actual 
implementation may vary from the method discussed. Moreover, various other 
improvements and modifications to this invention may be evident to those skilled 
in the art, and those improvements and modifications fall within the scope of this 
invention as set forth below. 

While embodiments of the invention disclosed herein are presently 
preferred, various changes and modifications can be made without departing 
from the spirit and scope of the invention. The scope of the invention is indicated 
in the appended claims, and all changes that come within the meaning and range 
of equivalents are intended to be embraced therein. 



